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INTRODUCTION 


CANUTE was designed to prepare and edit paper tapes in FIO-DEC or ASCII codes using the 
Type 28 Teleprinter normally found on the PDP-4. The program includes commands which will 
read and punch paper tape; print, delete, change, and insert text. 

The basic units of data handled by CANUTE are a "page" and a "line." 

A page on paper tape consists of all text between two stop codes; a page in memory consists of 
all the text in CANUTE'S buffer. 

The contents of the buffer are divided into "lines." A "line" is the string of characters between 
two carriage returns, an^includes the last carriage return. The lines in the page are implicitly 
numbered in decimal starting at 1, and may be referenced by their line numbers. 

OPERATION OF CANUTE 

CANUTE operates in two modes: 

1 . Command Mode. All characters typed by the user are taken as commands to CANUTE. 

2. Text Mode. All typing is assimilated as part of the text and stored in the buffer, where 
it may be examined or punched out later. 

When CANUTE is running, the state of the link will indicate which mode CANUTE is in: 0 for 
command and 1 for text. 


Commands 

The general forms which commands may take are: 

nL i) 

n ,m L ^ 

where n and m are the first and second arguments, and L is a single command letter followed by 
a carriage return. 

Commands, as shown later, may have zero, one, or two arguments. Those commands which 
take no arguments will not be executed if they are provided with any. If a command takes 
arguments which refer to a line or lines of text, then the arguments must refer to lines actually 
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in the buffer. If h,o argument indicate the first and last lines of a group, then the first must 
be smaller than the second. 

The command is made final by the carriage return. All typing on a single line may be erased 
at any time before typing the carriage return by typing line feed. Whenever an error in for- 
mat, illegal use of arguments, or an illegal control letter occurs, CANUTE types a question 
mark (?) and ignores all previous typing on that line. 

Arguments 

An argument may be an arithmetic expression containing decimal numbers, the character per- 
iod (.), and the character slash (/). The operations are addition, specified by space, and 
subtraction, specified by minus sign. 

Period 

The character period (.) in command mode is shorthand for the number of the last line refer- 
enced. For some commands, the value of period after the completion of the command is ob- 
vious; for others, less so. 

After a delete, the value of period is equal to the number of the line preceding the deleted 
line (s). This includes the value zero if line one was deleted. After an insert (I), append 
(A), or change (C) command, the value of period is equal to the number of the last line in- 
serted or if none was inserted, period has the value of the line after which the text would have 

been inserted. 


The character slash </) may be used in command mode as shorthand for the number of the last line 
on the page . 

Colon 

In command mode, typing colon will cause CANUTE to print the octal value of the last expres- 
sion typed. For example: to find the number of the last line on the page, type slash followed 

by colon. 
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Tabulation 

Some PDP-4's have tabulation hardware, while others do not. The S key in figures case is al- 
ways the tab key, and tabs will be spaced out on machines which do not have tab hardware. 
ACSI should be set to one when operating CANUTE. on machines which do not have tab hard- 
ware to specify that spacing should take place when a tab is processed from the input keyboard. 
Tabs are always spaced on output. 

Blank Key 

Striking the blank key in command mode will cause the next line to be printed. 

There are two distinct uses of the blank key in text mode: 

1. |f the blank key is the first character struck on a line, CANUTE will return to the 
command mode, having completed its assigned task. 

2. If the blank key is struck after some text has been typed on the current line, the last 
character will be erased. 

The blank key may be repeatedly struck, removing one character per stroke until all characters 
are removed from the line. At this point, if the blank key is struck again, control returns to the 
command mode. When using the blank key to erase, the use of the character dollar sign fol- 
lowed by a character is considered a single character. (See Appendix 1.) As stated previously, 
the link will contain a 1 when in text mode, and a 0 when in command mode. 

Commenting Mode 

When in the text mode, a line may be terminated by the character pair, dollar sign, carriage 
return. For the line in question, this has precisely the same effect as terminating with a car- 
riage return. 

However, it has the additional effect of causing the next line in the buffer to be typed out up 
to but not including the carriage return, and leaving control in the text mode as if the user had 
typed in the line. 

The user may now perform on the line any of the normal text editing operations, such as eras- 
ing characters by striking the blank key, erasing the entire line by line feed, terminating the 
line with a carriage return (or dollar sign, carriage return) or adding text, such as comments, 
to the line before completing it. 
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CANUTE uses the program interrupt facility for all I/O service. Paper tape and Teletype in- 
put and output are fully buffered. Consequently, the paper tape reader and punch may be 
active simultaneous with typing in by the user. 

The punch buffer will hold approximately one-half page of commented program (512 characters) 
or a full page of uncommented program text, so that CANUTE will be ready to process commands 
almost 9 seconds before punching terminates. In addition, CANUTE will accept and buffer up 
to 40 characters of typed input while doing other operations, such as tape-to-tape. When 
CANUTE processes (as opposed to accepts) each carriage return, it types a line feed; so this 
response signal may be used to determine when CANUTE has caught up with the user s typing. 

In all cases, when CANUTE responds to a carriage return with a line feed, the line preceding 
the carriage return has been processed. 

If an interrupt occurs which CANUTE cannot process, the computer will halt displaying the 
status register in the AC lights. To remove the offending interrupt, load the IOT which will 
clear the source of the interrupt into the AC switches, and press CONTINUE. Reset the AC 
switches, and press CONTINUE again to execute the IOT and proceed. 

Storage Capacity 

CANUTE will store about 6000 characters on a 4K machine, or 18,000 characters on an 8K 
machine. This corresponds to about 8 (4K) or 24 (8K) pages of uncommented program, or about 
3 (4K) or 9 (8K) pages of heavily commented text. 

If CANUTE is executing a read command when the buffer becomes almost full, the reader is 
stopped after the next carriage return so that no characters will be read that cannot be packed, 
and a message is typed. If the buffer becomes full, a diagnostic is typed and no more characters 
may be processed before the entire contents of the buffer are killed. 

To restart CANUTE without affecting the contents of the buffer, start at 22g. 

Loading Canute 

To use CANUTE, load the program tape. The program will start automatically. Set AC1=1 if 
the Teletype does not have tab hardware. Set AC17 to 0 or 1 depending on whether parity 
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checking is or is not desired when reading tape. Set all other AC switches to 0. The program 
is now ready to accept commands. 


in- 

icters) 
mmands 
sr up 
n 

his 

Ding. 

iding 

ne 

will 

AC 


8K 

■ about 

r is 

packed, 

laracters 


Parity Check 

CANUTE will parity check while reading if AC17=0. Upon encountering a parity error, a dia- 
gnostic which includes the line number and character will be typed; and processing will con- 
tinue with the offensive character replaced by the character with code 76 , which is an unused 

o 

character in the FIO-DEC set. This code will print as dollar sign, space, on the Teletype. 

If AC 17=1, parity errors will be ignored. 

^ Suppressing Punching 

Punching may be suppressed by putting up bit 0 and leaving it up until the command given is 
completed . 

Print Suppression 

It is occasionally desirable to stop printing which is in progress. To do this, put AC switch 0 
up, then down. After suppressing printing, the current line indicator will hold the last line 
that would have been printed had printing not been suppressed. 


Special Key Controls 


blank key (text mode) 

blank key (control mode) 
line feed 

/ carriage return 

dollar sign, carriage return (text mode) 

$ddd 


1) leave text mode 

2) erase last character 
print next line 

delete anything typed or type next 
line if nothing typed (control mode) 
complete specified action 
complete line and type next line remaining 
in text mode . 

in text mode, dollar sign followed by 
three octal digits will put that code in 
the string; in lower case if the first 
digit is 0, in upper case if the first 
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AC Switch Controls 


bit 0 
bit 1 
bit 14 



up then down suppresses punching or printing 
up for Teletype without tab hardware . 
up: during ASCII output, translate the tab 
character into spaces on output 
up for ASCII output; down for FIO-DEC 
up for ASCII input; down for FIO-DEC 
up to suppress parity checking when reading 


EDITING COMMANDS 


Commands 

Arguments 

Action 

nD 

1 

Delete linen. The line that was n+1 now becomes line 
n, and the line that was n+2 now becomes line n+1, 
etc. Period (.) will be set equal to n-1 . 

n, mD 

2 

Delete lines n through m, renumbering all lines after 
line m appropriately. Period will be equal to n-1 . 

K 

0 

Kill. The contents of the buffer are erased, and 
CANUTE reset. 

A 

0 

Append to the buffer. After typing a line feed, 
CANUTE is ready to accept text input. Text will be 
appended to the end of the buffer. The correspon- 
dence between the Teletype characters and the FIO- 
DEC set is contained in Appendix 1 . The values of 
slash (/) and period (.) are updated appropriately. 
Period will be equal to the number of the last line 
typed in. 

nC 

1 

Change line n. Line n will be deleted and the text 
typed in inserted in its place. If the input text is 
more or less than one line, slash and period will be 


Commands 

Arguments 

Action 



updated appropriately. Period will be equal to the 
number of the last line typed in. 

n, mC 

2 

Delete lines n through m, and insert the incoming text 
in their place. Period will be equal to the number of 

the last line typed in. 

nl 

1 

Insert the incoming text before line n. Period will be 
equal to the number of the last line that was inserted. 

PRINTING COMMANDS 

Commands 

Arguments 

Action 

nL 

1 

Print line number n on the Teletype. The value of 
period (.) will be set equal to n. 

n,mL 

2 

Print lines n through m. The value of period (.) will 
be set equal to m upon the completion of the command. 

W 

0 

The entire contents of the buffer are printed. 

nW 

1 

Write n pages. Perform the sequence K, R, W, n times 
inserting enough line feeds to space to the top of the 
next page each time. The buffer will be empty upon 

completion. 

Q 

0 

Print the entire contents of the buffer, suppressing all 

text on each line from the second tabulation. 

nQ 

1 

Print line n, suppressing all characters from the sec- 


ond tabulation on. 

Same as Q, but lines n through m. 


n,mQ 
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Commands 


Arguments 


Action 

Get. Scan from (not including) line n until a line 
which begins with a character other than tabulation, 
carriage return, or slash is found, and print if. 

Backup one line, and print it. 


Commands 


Arguments 


TAPE COMMANDS 


Action 


Wm • • " 


H:1 


m : 


Read into CANUTE s text buffer from paper tape until 
a stop code or the end of tape is encountered. 

Read until n lines or a stop code have been read (not 
pages). 

Skip one page on tape. The buffer remains unchanged. 
Skip n pages of text. The buffer remains unchanged. 
Execute the sequence P, S, K. 

Punch the entire contents of CANUTE'S buffer, a stop 
code, clear the buffer, and read a new page from tape. 
This command has the effect of combining the com- 
mands, P, S, K, R. 

Same as N, except that the nextm-1 pages from tape 
are copied tape to tape before reading the mfh page 
into the text buffer . This command is the same as P, 

S, (m-1) T, R. 

Transfer n pages directly from tape to tape. The buffer 
will be clear when the command is complete. If with- 
in the range of T there are two stop codes in a row 
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Commands 

Arguments 

Action 



separated only by tape feed, the second will not be 
punched but will be counted as a page. 

P 

0 

Punch some tape feed, then the entire contents of 

CANUTE'S buffer. 

nP 

1 

Punch line n only. 

n, mP 

2 

Punch lines n through m. 

S 

0 

Punch some tape feed and a stop code. 

n, mX 

2 

Insert n lines from tape (or until a stop code is en- 
countered) after line m. 

nF 

1 

Punch n lines of tape feed. 
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APPENDIX I 


CHARACTER SET EQUIVALENCES 


To provide a way of representing all the characters in the FIO-DEC set it was 
necessary to use an "escape character." When the escape character "$" appears 
in text mode, the character that follows if is interpreted differently than had 
it been typed alone. 

For example, the upper case FIO-DEC letters are represented by preceding 
the Teletype letter by a dollar sign; whereas the lower case FIO-DEC letters 
are represented by the letter itself. The equivalences for the punctuation char- 
acters preceded by a dollar sign are contained in Appendix II. 

Some of the factors involved in the choice of equivalences were compatibility 
with EDMUND, ease of use in preparing PDP-4 Assembly Language and FOR- 
TRAN Language programs, and future use of CANUTE for editing tapes in 
ASCII code. 
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FIO-DEC 

0 to 9 
a to z 
A to Z 


D 

V 

A 

< 

> 

r 

7 


+ 

) 

j 


$ (vertical strike, capitals) 
: (center dot, period) 

, (center dot, comma) 


APPENDIX II 
TELETYPE CODES 
Teletype 28 

0 to 9 
A to Z 
$A to $Z 
$" 

$' 

$? 

$, 

$/ 

$# 

$- 

$& 

I 

$; 

/ 

? 

, (comma) 

$: 

$. (center dot) 

(under bar) 

~ (minus) 

& 

) 

$) 

' (overbar) 

$'. (non-spacing vertical strike) 

$( 

• (period) 

# 

$'.$S 


ASCII 

0-9 
A - Z 
A - Z 


& 

< 

> 

T 

o 


n.a. 

+ 

) 

] 

n.a. 

\ 

( 


[ 


$ 

: (colon) 
(semi-colon) 


In addition when translating from ASCII to FIO-DEC 

Pair, carriage return, line feed All tape f d Carna9e refurn generates the character 
come form feeds. P ^ ^ ASC " stop codes (s) be- 
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APPENDIX III 


t 

COMMAND SUMMARY 


Command 

A 

B 

C 

D 

F 

G 

I 

K 

L 

N 

O 

P 

Q 

R 

S 

T 

W 

X 

z 


append 

back up one line 
change 
delete 
tape feed 

get next address tag 
insert (before) 
kill 

list line 

punch, stop code, kill and read 
punch, stop, code and kill 
punch 

suppress comments 
read and append 
punch stop code 
tape to tape 
write page(s) 
read and insert 
skip pages 
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